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1.1 


eo AND OVERVIEW 


BACKGROUND 

The 802 logical IInk control layer server (802 Ile Is) Is a 
component of the lacs driver in the lan subsystem. The 802 IIc 
ls Interfaces to the IIc type 1 layer [nstance in the lacs. The 
802 Ile Is can be termed a 16 entenston of the lacs layer 
Instance. The 802 IIc Is currently supports type 1 services 
only. 


BASIC PURPOSE 


The 802 IIc Is [TS an extensfon of the 802 Ile layer entity 


In the lacs. The user of this service will be operating [n a 
connectionless enviroment. The type 1 Ile user must associate, 
then activate the local and remote saps as described In the Idis 
component specification. The user may then fssue read, write, 
event or deactivate with queue abort requests. The read and 


write requests must include the remote sap the user wishes to 
commulfcate with.. 

The 802 Ile Is has several purposes, they are: processing 
read data, transmit data, and event requests and processing flow 
control at the sap level. | 


BASIC STRUCTURE 


Figure 1 shows the relation of the 802 IIc Is to the other 
components of the lacs dirver. Figure 2 shows the subcomponents 
of the 802 IIc Is. The following is a brief description of the 
functions of each subcomponent of the 802 IIc Is. 


determination routine - This routine determines - which 
routine to branch to, the desisiton is made from the major 
function code [In the forb. The routine will branch to the 
xmit data or read data or event request processing routines 
depending on the forb function code. 


transmit data request processing routine - This routine will 
perform pre and post processing of the transmit data forb. 


The routine will bulld a xmit data Icb from [Information [In 
the forb, [fssue the [cb to the lacs. When the lacs 
completes the I[Icb, the routine will update the forb status, 


then post the request back to the user. 


read data request processing routine =- This routine will 
perform pre and post processing of the read data iorb. The 


routine will bulld a read data Icb from Information In the 
lorb, [Issue the Icb to the lacs. When the lacs completes 
the Icb, the routine will update the forb status, then post 
the request back to the user. . 
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LAN L6 SOFTWARE ARCHITECTURE 
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1.4 


event request processing routine = This routine will perform 
pre and post processing of event forbs. The routine will 
bulld an event Icb from information In the forb and the 
event mask in the rt, then [f[ssue the Icb. When the lacs 
completes the Icb, the routine will update the forb status, 
then post the request back to the user. 


flow control routines - These routines will test flow 
control counts for the sap. The lacs maintains the counts- 
and these routines update the counts via a credit mechanism 
which is defined In the eps. 


issued to the lacs. After the determination the routine 
will return to the calling routine wilh a status specifying 
whether the Icb can be sent or not. 


BASIC OPERATION 


1.4.1 DETERMINATION ROUTINE 


1.4. 


The determination routine Is invoked via a branch from the lIdis 


determination routine. All requests [Issued to the 802 IIe Is 
enter at this routine. The routine will fetch the major function 
code from the forb, from the function code the routine will branch 


to either the xmit data routine, read data routine or event 
routine. 


2 TRANSMIT DATA REQUEST PROCESSING ROUTINE 


The xmit data request processing routine will be Invoked via a 
branch from the determination routine for pre request processing 
or a call from the Idms when a Icb Is completed for post request 
processing. Therefore the routine has two subcomponents: pre 
request processing and post request processing. The routines are 
defined below: | 


xmit data pre request processing routine - This routine will 


validate the request. Cali the build Icb routine [In the 
Idis. The routine will ffll in the Ile type 1 specific 
fields of the Icb. The routine will call the executive 
address absoultizing routine and place the address(es) Into 
the Icb. The routine will call the flow control routine. 
Upon return from the flow control routine if there is no 
error the routine will call the Idms to Issue the Icb to the 
lacs. When the Idms return the routine will call the 


terminate task rotufine [In the I[dis. 


Errors reported by the xmit data pre request processing 
routine are: 


, 1. Invalid forb parameter. 


2. Flow control routine returns an error. 
5% Ldms rotulfne returns an error. 
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4. Bulld {cb routine returns an error. 
( xmit data post request processing routine - This routine 
will be tftnvoked at Interrupt level from a call from the 
[dms. The routine will be passed a pointer to a completed 
lcb, from the Icb the routine will find the forb associated 
with the Icb, update the forb status from [Information [fn the 
completed Icb. The routine will call the flow control 
routine. The routine will then return to the !dms so the 


ldms can finish it's [Interrupt processing. 


Errors are reported by the xmit data post request processing 
routine are: 


Ls Flow control routine returns with an error. 
1.4.3 READ DATA REQUEST PROCESSING 


The read data request processing routine will be invoked via a 
branch from the determination routine for pre request processing 
or a call from the Idms when a Icb Is completed for post request 
processing. Therefore the routine has two subcomponents: pre 
request processing and post request processing. The routines are 
defined below: 


read data pre request processing routine - This routine will 


validate the request. Call the bulld Icb routine fn the 
( Idis. The routine will fItll in the Ile type 1 specific 
cw flelds of the Icb. The routine will call the. executive 
address absoultizing routine and place the address(es) Into 
the Icb. The routine will’ call the flow control routine. 
Upon return from the flow control routine If there [fs no 
error the routine will call the Idms to ftssue the Icb to the 
lacs. When the Idms return the routine will call the 


terminate task rotuline In the Idlfs. 


Errors which may occur [In the read data pre request 
processing routine are: 


le Invalid forb parameter. 

2. Flow control routine returns an error. 
Dus Ldms rotuine returns an error. 

4. Build Icb routine returns an error. 


read data post request processing routine - This routine 


will be fnvoked at Interrupt level from a call from the 
[dms. The routine wlll be passed a pointer to a completed 
Icb, from the Icb the routine will find the forb associated 
with the Icb, update the forb status from Information [n the 
completed Icb. The routine will call the flow control 
routine. The routine will then return to the Idms so the 


Idms can finish it's interrupt processing. 
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Errors are reported by the read data post request processing 
routine are: 


1.4.4 EVENT REQUEST PROCESSING 


The event request processing routine will be [fnvoked via a branch 
from the determination routine for pre request processing or a 
call from the Idms when a Icb [fs completed for post request 
processing. A chagne event mask request can also be issued. 
Therefore the routine has three subcomponents: pre request. 
processing and post request processing and change event mask. The 
routines are defined below: 


event request pre processing routine =- This routine will 
upon receiving the request determine from the device 
specific bits in the forb if the request is a change event 


mask request and [f so will jump to the change event mask 
routine. Otherwise, the routine will set the event request 
processing bit in the first fT. lf there Is an event 
request outstanding the routine will dequeue and post the 


current event with an error status, then enqueue the reugest 
on the first Tt. The routine will then test if there any 


event Icbs queued on the event Icb queue. lf there are |Icbs— 
queued the routine will check the mask of each completed 
event Icb for a matching mask fin the lIorb. lf a matching 


mask is found, the event request is updated, the event which 
occured [s placed [n the forb and the request is dequeued 
and posted, the routine will then turn off the event request 
processing bit off and terminate the task. lf a matching 
mask {[s not found [n The queue of event Icbs, the routine 
will turn off the event request processing bit off and 
terminate the task. lf no !cb are. on the event queue, the 
routine will turn of the event request processing bit and 
terminate the task. 


Errors which may occur in the event request pre processing 
routine are: 


1. Invalid forb parameter. 
event request post processing routine - This routine will be 
Invoked when a event Icb is completed by the lacs. The 
routine will test the event request processing bit, If the 
bit is set the routine will queue the Icb on the tall of the 
event Icb queue off the first tt, then return to the Idms. 
lf the bit fs not set, the routine will test if there [fs an 
event forb outstanding. lf there [fs no event torb 
outstanding the routine will queue the Icb on the tall of 
the event Icb queue off the tt, then return to the Idms._ If 
an event forb Is outstanding, the routine will test if the 
event ftorb matches the mask [n the event Icb, If the masks 
do not match the Icb [Ss queued on the tail of the event Icb 
queue off the tt, and returns to the Idms. lf a match Is 
found the routine wil! dequeue the event iorb, update the 


if o rb s ft a Tu is , 
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place the event mask from the Icb into the forb, then posts 
( the request, the routine will then return to the Idms. 


Errors which may occur [In the event request post processing 
routine are: 


Currently there no errors. 


change event mask routine - This routine will be [Invoked by 
the event request pre processing routine. When this routine 
[s activated there will be a pointer to an change event mask 
forb. The routine will change the event mask field [In The 
tt, then dequeue and post the reugest, then terminate the 
task. 


Errors which may occur during processing of the change event 
mask rotulne are: : 


1. Invalid forb parmameter. 
1.4.5 FLOW CONTROL PROCESSING 
There are two flow control routine in the 802 type 1 Ile Is, 


they are pre order flow control processing and post order flow 
control processing. 


pre order flow control routine - This routine will be called 
by the read data or transmit data pre request processing 
routines. The routine will test If the user has exceeded 


the read or write credit value, and {ff so the routine will 
post the request back to the user with an error, then return 
to the caller with an error status. Otherwise, the routine 


will return to the calling routine with a successful status. 

post order flow control routine - This routine will be 
called by the read data or transmit data post request 
interrupt processing outines. . The routine will add the 


credit amount to the current credit amount, then return To 
the calling routine. 

2 EXTERNAL SPECIFICATIONS 

2.1 OWNED DATA STRUCTURES 


The the data structures owned and used by the lan subsystem are 
defined in the lan 16 data structures document. 


2.2 EXTERNAL INTERFACES 
2.2.1 MOD400 EXECUTIVE SOFTWARE ROUTINES 
2.2.1.1 ZHCOMM - Null address 


ae 
C function: Will load the null address when referenced I[.e. Idb 


a, Oy = 
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$b5,<zhcomm will load $b5 with the null address. 
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2.2.1.2 ZXD_TR - Internal terminate 
entry: Inj %$b5,zxd_tr 
Input: $r2 = completion status for request 
$b4 = new default start address or null 
$b5 = return 
output:  $r1 = 0 = no error on Internal terminate 
$b1 = address of IRB for next request or is null if 


hardware [interrupt 
$b4 = address of RB for next request 


modifies: any register may be modified 


function: Dequeue and post currently dispatched request. 


next request in queue of task requests. Delete task if 


queue empty and delete bit on. Suspend task until 
request or hardware [Interrupt at Issuing task's 


If queue empty and delete bit off. 


2.2.2 STANDARD !ORB FORMAT 
rb_Irx 
input - bit 0- rb adr points to a bd when set 
| bit 1-3 = na 
bit 4-f - Irn when rb_ct2 bits O-7 = x'fd! 
output = na 
rborrb 
input: na 
output: na 
rb_cti 
inputs bit O-7 = mbz 
bit 8-e - na 


bit f - must be set 
output: bit O-7 = status 


60 = event successful 

64 - Inval!ld lorb parmaeter 

6b - event aborted, reference ro_ fss 
for reason 

6c - Inconsistent request, reference 


field for reason 
Same as input 


oO 
-+ 
OO 
a 
—h 
' 


Get 

next 

level 
‘a - 

field 

_ fss 
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( 


rb_ct2 


Input: 


outpuT: 
rb_adr 


Input: 


Output: 
rborng 


Input: 


outpuT: 
rb_dvs 

Input: 

OutpuT: 
rborsr 

Inputs 

outpufT: 
rb_stl 


Input: 
output: 


bit O-7 - Irn 

bit 8=-a = na 

bit b= must be set 

bit c-f - function code 
bit c-f = e - event forb 
bit c-f = 1 = write forb 
bit c-f = 2 = read forb 

same as Inpuf 


polnter to buffer, or If rb_Irx bit 0 is set this 
field contains a pointer to a buffer discriptor, 
or this field may be null If no data Is being 
passed (f.e. event forb) : 

same as Input 


range of the buffer, or total range of all buffers 
In the buffer discriptor block [f bit O In rb_Irx 
is set, or mbz ff no data Is being passed 

same as [nput 


bit 0-7 = class of service 
bit 8-f =- mbz 
same as [nput 


mbz | 
residual range of the buffer for read operations 
only, or same as input for all other operations 


mbz 

bit O-7 = same as Input 

bit 8 - Invalid function code when set 

bit 9 = ram memory exausted when set 

bita- ram location non-existent when set 
bit b= ram parity error when set 

bit c - level 6 memory yellow when set 

bit d= level 6 memory non-existent when set 
bit e- level 6 bus parity error when set 
bit f - level 6 memeory red when set 
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rb_ext 
Inputs: 
Output: 
rb_fsf 
input: 
output: 
rb_fss 
Inputs: 
cutpuTt: 
rb_abs 
Input: 
output: 
rb_tira 
Input: 
OutpuT: 
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bit 0-7 = xx | « 
bit 8-f = xx oy 
same as I[npuf 


function specific function code 
forb function code = e 
0010 - sap event 
0020 = connection event 
0040 - sm event 
forb function code = 1 
0010 - cl write 
0020 = co write | 
0040 - expideted co write 
forb function code = 2 
0010 = cl read 
0020 =- co read 
0040 = expideted co read 
same as input 


mbz 

function specific status 
0001 = sap already active 
0002 - lack of resources | | 
0004 = controller down cad 
0008 - sm Is error 
0010 - Irn already In use 
0020 - sap already active 
0040 - sap already disconnected 
0080 = receive buffer too smal | 


mbz 
accual buffer size when rb_fss = 
same as input 


0080, otherwise 


logical remote address for for read 
and event requests 
logical remote address for read, otherwise same as 


Input 


writes, mbz 


— 
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2.2.2.1 EVENT [ORB EXTENSIONS 


( rb _evm 


Input: event mask 
bit f = data arrival event 
bit e =~ additional write credits available 
bit d = sap deactivated 


outpuT: same as Input 
rb_evi 
Input: mbz 
output: event [ndication mask 


bit f - data arrival event 
bit e - additional write credits available 
bit d - sap deactivated : 


rb_elf 
Inputs: mbz 
output: amount of additional write credit when rb_evi bit 
e set, otherwise same as Input 
rb_ecb 
input: mbz 


output: trash 


i 


2.2.2.2 WRITE IORB EXTENSION 


rb awe 

input: mbz 

output: amount of additional write credit 
rb web 

Input: mbz 


output: trash 
2.2.2.5 READ !ORB EXTENSION 
rb arc 


Input: mbz 
output: amount of additional read credit 
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rb oreb 

Inputs: 

output: 

2.2.5 STANDARD LCB 

cb_pri 

Inputs 

output: 
cb_ncb 

Inputs: 

output: 
cb ret 

Inputs: 

output: 
cb_lit 

input: 

output: 
cb_frw 

inputs 

OoutpuT: 
cb_itp 

input: 

Output: 
cb_ind 

inputs 

outpuT: 


mbz 
trash 


FORMAT - 


mbz 
na 


mbz 
na 


address 
same as 


address 
queued 
same as 


bit O-3 
bit 4-7 
bit 8-f 
same as 


address 
on null 
same as 
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of caller's ret 
Input 


of the lift In which 


this Ieb 


- mbz (lorb major function code ?) 


- XX 
Input 


of the post processing 


Input 


indicators | 
bit 7 - cb_itp points to a trb when set 


bit 6 


- sm Icb when set 


all other bits mbz 


same as 


input 


routine, 


will - be 


or trb, 


oo 
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cb_Icw 
Input: bit 0-5 = mbz 
bit 6-9 = cpu number to Interrupt 
bit a-~f - level to Interrupt the cpu 
output: same as [nput 
cb_fsf 
Inputs function specific function code 
function codes for read Icbs are: 
0012 - cl read 
0022 - co read 
0042 = co exp!ideted read 
function codes for write Icbs are: 
0011 - cl write 
0021 - co write 
0042 - co expideted write 
function codes for event Icbs are: 
OOle - sap event 
00Ze - connection event 
004e - sm event 
output: same as [Input 
cb_cts 
7 Input: mbz 
( output: bit 0-7 - rfu and mbz 
et bit 8 = Invalid function code when set 
bit 9 = ram memory exausted when set 
bit a- ram location non-existent when set 
bit b = ram parity error when set : 
bit c - level 6 memory yellow when set . 
bit d- level 6 memory non-existent when set 
bit e- level 6 bus parity error when set 
bit f = level 6 memeory red when set 
cb_fss 
Input: mbz 
output: function specific status 
| 0001 - sap not active 
0002 = lack of resources 
0004 - controller unavailable 
0008 = sm layer [instance error 
0020 - sap already active 
0040 = sap already deactivated 
0080 - recieve buffer too smal | 
0100 - {fllegal logical address 
0200 - invalid Icb 
0400 - write credit violations 
0800 - read credit violations 
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cb_ 


cb_ 


cb_ 


cb_ 


cb 


Cb_ 


cb_ 


cb 


cb_ 


cbs 


Inputs 
Outpuf: 


abs 
Input: 
outpuT: 
|sa 


Inputs 
output: 


[ra 
Inputs 


Output: 


trg 


Input: 
output: 


bet 


Inputs 
output: 


ad] 


Inputs 
Output: 


rgi 


Input: 
output: 


rsi 


Inputs 
OoutpuT: 
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mbz 

bit 0 - lcb is complete when set 
bit 1 - Icb not processed when set 
bit 2-f =- rfu and mbz 


mbz 
actual 
same as 


buffer otherwise 


Input 


size if cb _fss = 0080, 


local address for cl 


Input 


logical 
Same as 


operations 


logical remote address for cl mb z 
for event and read operations 
logical remote address for cl 


otherwise same as input 


write operation, 


read operations, 


total byte range peng 
Same as Input : 


number of buffers 
same as input 


buffer #1 address 
same as Input 


buffer #1 range 
same as Input 


mbz 


buffer #1 residual range 
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| cb_adz 
(— Input: buffer #2 address 
outpufT: Same as Input 
cb _rg2 
Input: buffer #2 range 
output: same as Input 
cb _rs2 
Inputs mbz 
output: buffer #2 residual range 
cb_ad3 
inputs: buffer #3 address 
output: same as Input 
cb _rg3 
input: buffer #3 range 
outTpuT: same as Input 
cb rs 
( Input: mbz 
al output: buffer #3 residual range 
cb_ad4 
Input: buffer #4 address 
output: same as [Input 
cb _rg4 
Input: buffer #4 range 
output: same as Input 
cb _rs4 
Input: mbz 
output: buffer #4 residual range 
cb_ad5 
Inputs: buffer #5 address 
output: same as Input 
cb rgd 
; Input: buffer #5 range 
( output: Same as Input 
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cb _rs5 
Input: mbz 
output: buffer #5 residual range 
cb_ad6 
[Inputs buffer #6 address 
output: same as Input 
cb_rg6é 
Inputs: buffer #6 range 
output: same as Input 
cb_rs6 
Input: mbz 
output: buffer #6 residual range 
cb_ad/7 
inputs buffer #7 address 
output: same as Input 
cb rg/ 
Input: buffer #7 range 
output: same as Input 
cb_rs/7 
inputs: mbz : 
output: buffer #7 residual range 
cb_ad8 
Input: buffer #8 address 
output: same as inpuf 
cb_rg8 
input: buffer #8 range 
output: same as [Input 
cb _rs8 
Input: mbz 
output: buffer #8 residual range 
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cb_evl 
Input: mb z 
Output: event [Indication mask 
bit f - data arrival event 
bite- additional write credits availbale 
bit d- sap deactivated 
cb_elf 
Input: mbz 
output: event information field 


aditional write credit (only [ff cb_evi = 0002) 
lenght of read buffer (only If cb_evi = 0001) 
reason for sap deactivatin (only If cb_evi = 0004) 


2.2.5.2 READ LCB EXTENSION 


cb_arc 
Input: mbz 
output: read credit count 
2.2.5.5 WRITE LCB EXTENSION 
( cb_awc 
Input: mbz 
output: additional write credit 


2.2.4 MOD400 EXTERNAL DATA STRUCTURES IMPLEMENTED 


The following system owned data structures are referenced by the 
lic 802 [le Is: 


Task Control Block (TRB) 

System Control Block (SCB) 
Logical Resource Table (LRT) 
Group Control Block (GCB) 
Resource Control Table (RCT) 
Intermediate Request Block (1RB) 


2.2.5 LACS DRIVER INTERFACE SERVICES ROUTINE USED 
The 802 Ile Is uses the following Idis routines, the 
definition of the [Input and output parameters can be found [In the 


[dis component specification: 


isbilcb - build Icb 


isvilob - validate forb 
x istmtk - terminate task 
( Isevnt - evnet routines 
Le Isasvb = assign segiment visiblity 
[sabs! - absoultize buffers 


= OO: = 
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2.2.6 LACS DRIVER MEGABUS SERVICES ROUTINES USED 
The 802 IIe IS uses the following l[dms routines, the 
definition of the [nput and output parameters can be found [In The 
[dms compnent specification. | 


msifior - Issue JIold or [ssue io routine 


2.353 INITIALIZATION REQUIREMENTS 


The clm process will load the Ile 802 Ilic Is into system 
memory, and configure at least one task level for the Ile 802 Ilc 
ls to run under. When the Ile 802 Ile Is fs loaded Into memory, 
it will perform a initialization subroutine. This routine will: 

Ls Reclaim patch space. 

No Initialftzation processing Is done when the llc 802 Ile Is 


is activated Initially by a request. 
2.4 TERMINATION REQUIREMENTS 


The {tle 802 Ile Is will be active as long as mod400 is 
active, therefore there are no termination requirements. 


2.5 ENVIRONMENT 
The following items are required by the Ile 802 Ile Is for 
it to perform it's task: 
ua Mod400 operating system. 
2. Any 16 computer model except 6/10 and 6/20. 


34 A lacs attached to the [6 megabus. 


4. Lan clm, 

De System manager layer server. 

6. A user of the lan subsystem to driver the I!e 802 IIc 
Is. 


2.6 TIMING AND SIZE REQUIREMENTS 


Currently memory usage and timing requirements are not an 
issue. However, the code should be be as efficient as possible. 


2.7 ASSEMBLY AND LINKING 


The software will be written [n Series 6 Assembly Language 
using a subset of the instruction set that [{sS present on all 
Series 6 systems. The IIe 802 IIc Is will be linked by the gcos6 


mod400 Iinker to produce one of the lacs driver's bound units. 
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2.8 TESTING CONSIDERATIONS 


( Since the product [Is new, all functions will be tested by 
the developer, and software test. 


2.9 DOCUMENTATION CONSIDERATIONS 
The Ile 802 IIe IS source listing will Include a program 
design language used by the developer to afd In the maintenance by 
future developers and also to altd tn the development by the 
developer. 
2.10 ERROR MESSAGES 


2.10.1  JORB ERROR MESSAGES 


es 0164 - Invalid forb parameters. 
Zs 016b = Request was not processed. 
D% 016c =- Inconsistent request. 


3 INTERNAL SPECIFICATION 

3.1 OVERVIEW 

_ The 802 Ile Is fs activated by efther the Idis determination 

( - routine branching to the type 1 determination routine or a call 

! from the Idms to one of the 802 I!c Is Interrupt routines, the 
interrupt routine must return to the Idms. 

3.2 SUBCOMPONENT DESCRIPTION 

3.2.1 DETERMINATION ROUTINE 


The determination routine [s Invoked by the IdIis determination 
routine. The Idis determination routine performs a branch to the 


802 Ile Is determination routine. The Idis determination routine 
will supply the following Input parameters: 

$b1 = a(Irb) 

$b2 = a(rct) 

$b4 = a(torb) 


The 802 Ile Is determination routine supplies the following output 
Darameters: | 


$b1 = a(iIrb) 
$b4 = alforb) 
$b2 = a(rct) 


The routine performs the following function: 


&. 99.-= 
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iz Retrieve the major function code from the forb. 


Ze Using a jump table f[ndex Into the table by the major 
function code to jump to the appropriate Pouriae: The 
jump table [Is described below: 


jmptbl equ §$ 
jmp error function code 0) 
jmp xmitdata function code 1 
jmp readdata function 
code = 2 
jmp error function 
code = 3 


jmp event function 
, code = e 

jmp error function 
code = f 


Where xmitdata Is the xmit data routine, readdata Is the 
read data routine, and event is the event routine, and 
error its a Invalid function code handling routine. 


3.2.2 XMIT DATA ROUTINES 
3.2.2.1 XMIT DATA PRE PROCESSING ROUTINE 


The xmit data pre processing rotuine [fs [Invoked by the 802 IIc Is 
determination routine. The xmit data preprocessing routine 
requires the following Input parameters: 


$b 1 
$b2 
$b4 


a(ftrb) 
a(rct) 
a(lorb) 


The xmit data pre processing rotuine supplies the following 
output parameters: 


none - task Is terminated 
The routine performs the following function: 


1. Validate the forb, this Involves testing the extension 
field to see If the forb [is of proper lenght, the range 
fleld must be non zero, and test of other fields that 
will be determined when the routine is [nplemented. | f 
an forb {fs fnvalid, the routine wiil call the dequeue 
and post routine with an [Invalid forb error status. 


2. If the forb [fs valid the routine will set a pointer to 


the Icb (In the extended forb), then call the bulld icb 
routine In the Idis. 


i OS es 
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3. Upon return from the bulld |Icb routine, the rotine wil! 
fill in the following flelds of the Icb: 
cb_frw - set the left byte to 9, set the right 
byte to the range of the Icb from the 


cb _sz word. 


cb_Iitp - set the address of the xmit data post 
processing routine. 


cb_ind - currently no bits are set, field is 


cleared. 

cb_csf - set the channel! specific function code, 
where the code is retrieved from is 
tbd. 

4, The routine will call the flow control routine, [If an 
error occurs the routine will call the terminate task 
routine. 

5. If no error resulted from the call to the flow control 
routine, the xmit data pre processing routine will set 
up the registers for the call to the Idms, then cal! the 
[dms. | 


8 
7 6. If the Idms returns to the xmit data pre processing 
{ routine with an error the routine will tbd, then call 
XU the terminate task routine. | 


7. If the Idms returns with no error, the xmit data routine 
will call the terminate task routine. 


3.2.2.2 XMIT DATA POST PROCESSING ROUTINE 


The xmit data post processing routine [Is [Invoked by the [dms when 
an icb completes. The Idms retrieves the cb_Itp field from the 
lcb and performs a Inj to the address. The address [In the Icb 
will be this routine. The xmit data pre processing routine sets 
up the address. The xmit data post processing routine requires 
the following Input parameters: 


$b1 = a(Iicb) 
$b5 = return address 
The routine will supply the following output parameters: 


none - returns to the address In the inputed $b5 
The routine performs the following function: 


1. Retrieve the pointer to the forb associated with the 
lcb. 


2. Update the rb_sti in the forb status word from the cb 
csf and cb_cts flelds in the I[cb. 


a a 
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3. Call the flow control routine. s 4 a 
4. Call the dequeue and post routine in the Idis. 
5. Return to the Idms. 
3.2.3 READ DATA ROUTINES 
3.2.5.1 READ DATA PRE PROCESSING ROUTINE 
The read data pre processing rotuine is Invoked by the 802 IIc Is 
determination routine when a read forb {s fssued by the user. 


The read data preprocessing routine requires the following input 
parameters: 


$b1 = alirb) 
$b2 = a(rct) 
$b4 = aliorb) 


The read data pre processing rotuine supplies the _ following 
output parameters: 


none - task is terminated 
The routine performs the following function: 


1. Validate the forb, this Involves testing the extension 
field to see If the ftorb Is of proper lenght, the range 


field must be non zero, and test of other flelds that 
will be determined when the routine Is Inplemented. | f 
an forb fs fnvalid, the routine will call the dequeue 
and post routine with an [invalid forb error status. 
2. If the forb ts valid the routine will set a pofnter to 
the Icb (in the extended lIorb), then call the bulld Icb 
routine [In the Idis. 
5. Upon return from the bulfld Icb routine, the rotine will 
fill In the following fields of the Icb: 
cb_frw - set the left byte to 9, set the right 
byte to the range of the Icb from the 
cb sz word. 
cb_itp - set the address of the read data post 
processing routine. 
cb_ind - currently no bits are set, field ts 
cleared. 
cb_csf - set the channel specific function code, 
where the code [s retrieved from is 
5 b d ® : a Ps 
i 
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4. The routine will call the flow control routine, [f an 
error occurs the routine wil! call the terminate task 
routine. 

5. If no error resulted from the call to the flow contro! 
routine, the read data pre processing routine will set 
up the registers for the call to the Idms, then call the 
Idms. 


6. If the Idms returns to the read data pre processing 


routine with an error the routine will tbd, then call 
the terminate task routine. 


7. If the Idms returns with no error, the read data routine 
will call the terminate task routine. 


3.2.3.2 READ DATA POST PROCESSING ROUTINE 


The read data post processing routine Is Invoked by the Idms when 
an icb completes. The Idms retrieves the cb_Itp fleld from the 
Icb and performs a Inj to the address. The address [In the Icb 
will be this routine. The read data pre processing routine sets 
up the address. The read data post processing routine requires 
the following Input parameters: 


$b1 = a(icb) 
$b5 = return address 
The routine will supply the following output parameters: 


none - returns to the address In the Inputed $b5 
The routine performs the following function: 


1. Retrieve the pointer to the forb associated with fhe 
Icb. 


2. Update the rb_sti In the forb status word from the cb 
csf and cb cts fields in the Icb. 


3. Call the flow control routine. 
4. Call the dequeue and post routine in the lIdis. 


5. Return to the Idms. 


3.2.4 EVENT ROUTINES 


3.2.4.1 EVENT REQUEST PRE PROCESSING ROUTINE 


eS 


The event request pre processing routine Is Invoked by the type 1 


determination routine via a branch. The routine will require the 
following Input parameters: 


2.95; < 
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$b1 = a(tIrb) 
$b2 = alrct) HP 
$b4 = a(forb) KY 
The read data pre processing rotuine supplies the following 
output parameters: 
none - task is terminated 
The routine performs the following function: 
1. If bit O In the rb_dvs word Is not set, then call the 
post request routine with an Invalid forb parameter 
status, cali the terminate task routine. 
2. If bit 0 Is set In the rb_dvs word, set the event active 
bit in the tt_Iid1l word In the Tt. 
3. If there is an event fiorb polinter [n the tt_erb field, 
then call the post request routine to post the request 
pointed to by the tt_erb field with an error status. 
4. Place the pointer to the forb into the tt_erb field. 
5. If any event Icbs are are [In the event Icb queue then 
test search the queue looking for a matching event mask, 
mask [In forb and Icb must match. If a match is found 
call the post request routine with a successful status, | os 
clear the tt_erb field, set the event active bit off and _— 
call the terminate task routine. 7 
6. If no event [cb are [In the queue or a matching mask Is 
not found to the forb In the event Icb queue set the 
event active bit off, call the terminate task routine. 
3.2.4.2 EVENT REQUEST POST PROCESSING ROUTINE 
The event request post processing routine Is [Invoked by Inj from 
the Idms when [tT has a completed event icb. The routine requires 
the following Input parameters: 
$b1 = a(icb) 
$b5 = return address 
The routine supplies the following output parameters: 
none - a return to the Idms Is performed 
the routine performs the following function: 
1. Retrieve the pointer to the Tt. 
Z2. If the event active bit is set, queue the Icb on the 
tail of the event Icb queue, return to the Idms. e 
Wy 
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os 3. If the event active bit Is not set, test If there [s an 
( ; event forb, If there Is no event lorb queue the Icb on 
a | the tail of the event Icb queue, return to the Idms. 


4. If there [s an event forb, queue the Icb on the tail of 
the event Icb queue, search from the start of the event 
lcb queue, [If a matching mask fs found, call the post 
routine with a successful status, return to the Idms. 


5. If there Is no matching mask found return to the Idms. 
3.2.5 FLOW CONTROL ROUTINES 


3.2.5.1 PRE ORDER FLOW CONTROL ROUTINE 
The pre order flow control routine is Invoked via a Inj 


from the recieve or transmit data pre request processing 
routines. The routine requires the following Input parameters: 


$b4 = aliorb) 
$b2 = a(rct) 
$b5 = a(lreturn) 


The routine supplies the following output parameters: 


$b4 = a(forb) 
$b2 = a(rct) 
$r1 = status 


0000 = ok to send Icb 
.0001 - user exceeded flow control values 


The routine performs the following function: 


Te Retrieves the current read or transmit credit count from 
the Ith tt, this ts determined from the jiorb function 
code. | 


2. If the count [Is zero, call the dequeue and post routine 
with an unsuccesful error status, return to the caller. 


3. If the count [S non zero, return to the caller. 
3.2.5.1 POST ORDER FLOW CONTROL ROUTINE 
The post order flow control routine Is Invoked: via a Inj 


from the recieve or transmit data post request processing 
routines. The routine requires the following input parameters: 


$b1 = al(lcb) 
$b2 = a(rct) 
$b5 = a(return) 


The routine supplies the following output parameters: 


a OO. x 
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$b1 = a(icb) 
$b2 = a(rct) 
$r1 = status 


0000 =- ok to send Icb 
0001 = user exceeded flow control values 


The routine performs the following function: 

1. Retrieves the current read or transmit credit count from 
the ith tt, this is determined from the Icb function 
code. | 

2. Add to the current count the credit value in the Icb. 

3. Return to the caller. 

PDL 
TBD 


ISSUES 
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